package com.eedi.framework.template.service;



import java.util.Collection;
import java.util.List;

import com.eedi.framework.template.controller.sys.vo.menu.SysTemplateMenuListReq;
import com.eedi.framework.template.controller.sys.vo.menu.SysTemplateMenuSaveReq;
import com.eedi.framework.template.controller.sys.vo.menu.*;
import com.eedi.framework.template.dal.dataobject.SysTemplateMenuDO;
/**
 * 菜单 Service 接口
 *
 * @author 永聚长青源码
 */
public interface SysTemplateMenuService {

    /**
     * 创建菜单
     *
     * @param createReqVO 菜单信息
     * @return 创建出来的菜单编号
     */
    String createMenu(SysTemplateMenuSaveReq createReqVO);

    /**
     * 更新菜单
     *
     * @param updateReqVO 菜单信息
     */
    void updateMenu(SysTemplateMenuSaveReq updateReqVO);

    /**
     * 删除菜单
     *
     * @param menuId 菜单编号
     */
    void deleteMenu(String menuId);

    /**
     * 获得所有菜单列表
     *
     * @return 菜单列表
     */
    List<SysTemplateMenuDO> getMenuList();

    /**
     * 基于租户，筛选菜单列表
     * 注意，如果是系统租户，返回的还是全菜单
     *
     * @param reqVO 筛选条件请求 VO
     * @return 菜单列表
     */
    List<SysTemplateMenuDO> getMenuListByTenant(SysTemplateMenuListReq reqVO);

    /**
     * 筛选菜单列表
     *
     * @param reqVO 筛选条件请求 VO
     * @return 菜单列表
     */
    List<SysTemplateMenuDO> getMenuList(SysTemplateMenuListReq reqVO);

    /**
     * 获得权限对应的菜单编号数组
     *
     * @param permission 权限标识
     * @return 数组
     */
    List<String> getMenuIdListByPermissionFromCache(String permission);

    /**
     * 获得菜单
     *
     * @param menuId 菜单编号
     * @return 菜单
     */
    SysTemplateMenuDO getMenu(String menuId);

    /**
     * 获得菜单数组
     *
     * @param menuIds 菜单编号数组
     * @return 菜单数组
     */
    List<SysTemplateMenuDO> getMenuList(Collection<String> menuIds);

    /**
     * 校验菜单ID是否存在
     * @param menuIds 菜单IDs
     */
    void validateMenuIds(Collection<String> menuIds);
}
